home *** CD-ROM | disk | FTP | other *** search
/ Personal Computer World 2009 February / PCWFEB09.iso / Software / Linux / Kubuntu 8.10 / kubuntu-8.10-desktop-i386.iso / casper / filesystem.squashfs / usr / share / doc / libfftw3-3 / README.Debian < prev    next >
Encoding:
Text File  |  2008-06-20  |  3.0 KB  |  64 lines
  1. fftw3 for DEBIAN
  2. ----------------------
  3.  
  4. Some of the changes made for version 3 of FFTW necessitated changes to the API,
  5. so you will need to make (minor) changes when moving existing programs to this
  6. version. See the documentation (in package fftw3-doc) for details.
  7.  
  8. In fftw2 separate packages included optimizations for SIMD
  9. instructions. In fftw3 all such optimizations (x86 and powerpc) are
  10. included in the regular libraries. The routines should automatically
  11. detect the capabilities of your processor. Also, the package contains
  12. three different precision versions (single and double as before, plus
  13. a new long double version).
  14.  
  15. The -dev version of a package contains the headers and a statically
  16. linked copy of the libraries. You need to install this if you intend
  17. to compile a program which uses fftw. Be careful when compiling
  18. against the static libs as the library linker (ld) looks for shared
  19. libraries first. Some people prefer to use static libraries as there
  20. can be a speed advantage (3-30%) on register starved architectures
  21. (like x86 machines).
  22.  
  23. The package also contains a threaded version of fftw.
  24. Using the threaded version is almost identical to using the non-
  25. threaded version, but the function calls are renamed and you
  26. need to call a special function first to handle some housekeeping.
  27. See the documentation for details.
  28.  
  29. Unlike fftw2, there are no MPI based libraries at this time. Upstream
  30. should release them soon. Once upstream adds MPI support, the Debian
  31. package will include it.
  32.  
  33. To top it all off, you can call fftw from fortran. See the docs at
  34. /usr/share/doc/fftw3-doc/html/Calling-FFTW-from-Fortran.html
  35. (needs package fftw-doc installed).
  36.  
  37. Checking the fftw library for correctness
  38. -----------------------------------------
  39. A 'make check' is run during the Debian build. This runs a number of tests
  40. on the library but does not test all aspects of fftw.
  41.  
  42. Some users may want to run more complete checks on the library.
  43. Unfortunately, it is difficult to compile or run the checks outside
  44. the source so a precompiled binary is not included with the package.
  45. To enable users to check the library for correctness, the
  46. instructions for compiling the source are included here:
  47.    apt-get source fftw3       (you need a deb-src line in /etc/apt/sources.list)
  48.    cd fftw3-3.0
  49. Run the configure line from debian/rules appropriate for your architecture and
  50. the precision you would like to test. For example, to run the double precision
  51. tests on an x86 machine you would run:
  52.    ./configure --prefix=/usr --enable-shared --enable-threads --enable-sse2
  53. Then compile the source and go into the tests directory:
  54.    make
  55.    cd tests
  56. You are now ready to run the tests. You can run individual tests yourself or
  57. you can run the automated tests. For details on running tests yourself, read
  58. the README file. There are three choices for the automated tests:
  59.    make check                 (takes a few minutes)
  60.    make bigcheck              (takes hours to run)
  61.    make paranoid-check        (you tell me how long it takes)
  62.  
  63. James A. Treacy <treacy@debian.org>, Thu, 24 Apr 2003 21:42:20 -0500
  64.